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Section 1— Introduction 


Welcome to the Boston Community Information System —- the Boston Commins! We are pleased to . 
welcome you as a participant. this experiment is a test of a new way of distributing world news and 
features from the New York limes (NYT) and the Associated Press (AP) wire service directly to 
people’s personal computers via radio waves. With our software and a special radio receiver 
connected to your IBM (or compatible) personal computer, you can receive up-to-the-minute 
information on the myriad topics carried by the New York Times and AP wire services, inciuiding world 
news, local events, financial reports (and some closing stock prices), business news, editorials, 
commentaries, features on the arts, and weather forecasts. With the Boston CommInS, you may even 
receive information on these topics before its announcement on the radio cr its publication in a 
newspaper! 

The Boston CommInS turns your computer into a personal information assistant that monitors the 
news as it happens. Acting on your instructions, your computer will ‘filter’? this flow of information, 
saving the stories that match your list of interests. Thus, you can waik up to the system at any time, 
und browse through the stories that the system has saved for you. Because your personal computer 
can receive and filter much more information than you could read yourseif, it can help you focus and 
enlarge your awareness of the world. You will probably find that the system consistently finds more 
articles of interest on certain subjects than you do. 


Additionally, users with a modem may access a full database of New York Times articles that is stored 
on several database servers at MIT. The commands used io access this database are exactly the 
aime as those which allow you to access the articles saved on your system. 


For best results, we recommend that you leave your personal computer running with the Boston 
ComminS software running whenever you are not using your personal computer for another task. 
tne radio station that carries our transmissions ts on the air 20 hours per day. If you teave your 
e/stem running overnight, it will be ready the next day with the latest news. Mast news is transmitted 
ssveral times a day, so you can use your personal computer for ather tasks without fear inat you will 
huss an important article. Addclitionally, the program can be usec! in a background mcde with 
programs like DesaView (TM) and Double-Dos (TM) with only 286K devoted to the software. 


This User’s Manual is designed to tell you everything you need te know to set up and operate the 
equipment and software loaned to you. We have prepared this manua! for new and experienced PC 
users alike. We hope the manual will answer all your questions about connecting our special digital 
raceiver to your PC, about using the software for the first time, and about customizing the scftware for 
your personal use. If you have difficulties, try re-reading this manual, especially the appendix on 
trouble-shooting, but if the difficulties persist, do call us for assistance at the Boston CommInS 
‘HOTLINE’, (617)-253-0007. 

Because this is an experiment, we are very much interested in your thoughtful evaluation of the 
Roston Commins. Not only do we want your first impressions of the system, 7c. your ideas on making 
the system easier to use during the first few hours, but we also want your later impressions, /.e. your 
suggestions and advice (on all aspects of the system) from the perspective of an experienced user. 
To this end, we will send you a Questionnaire each month, which you should return to us promptly. In 
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truth, we hope that you will send us additional information as the spirit moves you; we want to know 
your full thoughts on the system, not just your responses to the monthly questionnaire. In a sense, 
the monthly questionnares represent a minimum of feedback and evaluation from you; please do 
send more if you wish. 

As a participant in this experiment, you have signed an agreement concerning your responsibilities. 
Note that you must abide by this agreement, in spirit and in letter, or you will be asked to return all 
loaned equipment and software to us immediately. 

We welcome you to this experiment to test the Boston CommlInS, and we are looking forward to 
working with you in the coming months. 


OAL 


Professor David K. Gifford 
Massachusetts Institute of Technology 
Cambridge, Massachusetts 
September, 1986 
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Organization of this Manual 


This introduction is followed by three mcre sections, which describe, in turn: 
e the capabilities of the CommlInS software, and how to use it; 
® the information services provided by the Boston Commins; and 
© how to put together your own personalized ‘news filter’. 


There are seven appendices. Appendix lis the mast important one for new users: it describes how to 
connect the receiver to your PC, and now to install and run the software. Appendix Il is a guide to 
help users set up their modem for use with the remote system. 


Appendix Ill is a trouble-shooting guide, and contains descriptions of common problems and their 
solutions. 

Appendix IV is designed for users experienced with previous versions cf our software. It describes 
the basic changes in the current program. 

Appendix V is the reference section: all the commands are listed here. Appendix VI describes the files 
used by the system, and finally, Appendix VII contains a few words about the responsibilities of 
participants in the Boston CamminS experiment. 


How to Use this Manual 


First-time users should proceed in the foilowing order: 

© First, yau should read Appendix | — Getting Started and follow the instructions for unpacking 
the equipment, instahing it, and instahing the software. 

© After you install the hardware and software, you should read Section 2. It includes instructions 
for first-time users that you should follow. These instructions guide you through the section 
quickly and superficialiy, to give you a gener! idea of how io use the Cc: mmiIns software. 

o Next, you should skim Sections 3 and 4, to learn about the information services that are 
available, and to learn how to put together your own news filter. 

o Finally, you should turn back to Section 2, read the parts that you were asked to skip on first 
reading, and try out all the different commanus. 


Start with “Apsendix | —- Getting Started’. Good ituick! 
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Section 2 — Using the CommiInS Software 


: ‘aug 20, 12:35 
(type: nyt) (subject: newssummary) \ 
(subject: briefing) STATUS LINE 
(subject: findigest) 
(subject: business digest) 
(subject: wall street) 
(subject: patents or technology) 
{subject: telerate or rates) 
forecast® boston vicinity 
(subject: calendar) 
(subject: movie) 
ibm or compaq or (apple and computer) or ata 
wang or “data general" or “digital equipment 
"star wars” or sdi or "strategic defense” 
health risk 
mit or “massachusetts institute” 
harvard (category: not sports) 
aids 
(category: news) (priority: urgent | bulletin i flash) 


* 
WINDOW DISPLAY 


( 
( 
( 
( 
( 
( 
( 
¢ 
( 
( 
( 
( 
if 
¢ 
if 
¢ 
¢ 
( 


QUERY LINE 
ey = 

he receiver is running on port 1 
Welcome to the MIT Community Information System - Type F1 for help 


MESSAGE AREA 


Figure 2-1: The Screen Layout and the Window Selection Menu 


As shown in Figure 2-1, the ComminS software divides the screen of your PC into four separate areas: 
e The status line is the highlighted line at the top cf the screen. in addition to the date and time, 
the status line indicates which window is displayed below, which line or summary in the window 
is selected (if any), which lines or summaries are shown, and how many lines or summaries the 
window contains. 
e The query line, also highlighted, is the third liné from the bottom. The purpose of the query line 
is described in Section 2.1. 
e The message area occupies the bottom two lines of the screen. Messages from the system 
(such as acknowledgments and error messages) are displayed here. 
eo The window display occupies the remainder of the screen. It is used to display the following 
five windows: 
o the filter window, which contains your news filter, 
o the summary window, which contains article summaries, 
© the article window, which contains articles, 
o the diagnostic window, which contains details about the system's operation, and 
o the options window, which contains the setting of various controls that you can change. 
When the system starts up, it displays the filter window. To find out how to ask the system to display 
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the other windows, press F3': this instructs the system to show the window selection menu (see 
Figure 2-1).- A menu is a highlighted box containing a list of commands, one of which (the selected 


command) appears on a contrasting background. You can use the | and [7 keys to select any 
command in a menu; when you press <Enter>, the selected command is executed. If you do not want 
to execute a command, you can select DO NOTHING, or you can press the shorthand key <Esc>. If you 
press a key other than |, fT or <Enter>, the system will remove the menu and then act upon the key you 


pi essed.3 


You can use the window selection menu (see Figure 2-1) to instruct the system to display any of the 
{ive windows. As an alternative, you can simply press the corresponding shorthand key shown in the 
raenu (F2 for the filter window, F4 for the summary window, and so forth). The status line (at the top 
of the screen) always indicates which window is being shown. The shorthand keys work whether or 
not there is a menu on the screen; thus, you can a/ways ask the system to display any of the five 
windows by pressing F2, F4, F6, F8 or F10. If this is your first time using the system, you should take a 
look at the other wiridows before you read on. 


lf a window contains more than one screenful of text, this is indicated in the status line. To see whole 
text of the window, use the scro/ keys: 

<PgDn> Show the next page. 

<PgUp> Show ihs previous page. 

<Home> Show the first page of the window. 


<End> Show the last page cf the window. 
ln the filter window and the summary window, you can also use the the following keys: 
Shift- | Move forward one line (or summary) 
Shift-T Move back one line (or summary) 
l Select the next line (or summary) 
T Select the previous line (or summary) 


The shift key used in conjunction with T and | has the same effect as using the numeric iock key. 
That is, use af this feature causes the s~reen to shift as opposed to only cursor movement. 


Each of the five windows fas its own set of commands: for example, the filter window has a command 
for adding new filter lines, the article window has a command for going to the next article, and so on. 
The commands for each window are tisted in the command menu for that window. When you are 


looking at a window, press / to see the corresponding command menu. You can display all five 
command menus in turn by pressing F2 7, F4 7, F6 7, and so forth. Note that every command has a 
shorthand key, which ts iisted to the right cf the command in the menu. 


For your preiection, some commarics (such as DELETE ALL MATCHING ARTICLES) ask for confirmation 


lug ge refers to the gray function key on the left side (or top for some compatibles) of the keyboard labeled Fd. Similarly, FA, 
F2, etc. refer to the other function keys. 


2 : : ai , 
When you press a key, the systern usually responds right away. However, wnen the system is writing a new article on the 
disk, it responds only after the whole article has Leen written. 


SThus, you cin also remove a menu by pressing the space bar. 
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before they do anything When you execute such a command, a confirmation box appears on the 


screen. A confirmation box is a tiny menu with only two options: DO NOTHING and EXECUTE. Select 
EXECUTE and press <Enter> if you wish (o go ahead, or use the shorthand A-E." If you wish to cancel 
the command, execute the bO NOTHING Command or use the shorthand <Esc>. 

A help file is provided with the system which contains an overview of some basic commands. If this is 
your first time using the system, you should press Fl and look through this help file. It also contains 
some information not yet covered. You can view ihis file any time by pressing F1. 


‘the prefix “‘A-’' refers to the <AID key: for example, A-E means “hold down the <Alt key and press e”, Similarly, the prefix 
“C-" refers to the <Cirl> key: for example, C-D means “hoid down the <Ctrl> key and press a”. 
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2.1— The Filter Window 


aug 20, 12:36 


(subject: briefing) 

(subject: findigest) 

(subject: business digest) 

(subject: wall street) 

(subject: patents or technology) 
(subject: telerate or rates) 
forecast# boston vicinity 

(subject: calendar) 

(subject: movie) 

ibm or compaq or (apple and compute 
wang or "data general" or “digital 
"star wars” or sdi or "strategic de 
health risk 

mit or "massachusetts institute" 
harvard (category: not sports) 

aids 

(category: news) (priority: urgent 
x 


The receiver is running on port 1 
Welcome to the MIT Community Information System - Type Fi for help 


Figure 2-2: The Filter Window and its Command Menu 


The CommInS software monitors the information that comes in via the receiver, and “filters in’’ the 
articles that match your interests, based on the filter. Thus, the filter serves as your personal “interest 
profile’. The filter on the distribution disk serves only as an example to get you started — you will 
soon learn how to customize the filter for your personal use. 


Press F2 to see the filter window (see Figure 2-2). Each line in the filter corresponds to a specific 
topic. Each filter line is preceded by a number in parentheses, which indicates how many articles 
matching that line are on the disk.° 


One of the filter lines is highlighted: it is called the selected line.” You can select any line in the filter 
“yy means of the scro// keys, i.e. T, |, <PgDn>, etc. When you select a particular line, the contents of 
inat line appears on the query line so that you can use it as a query. If this is your first time using the 
system, select a line for which the number of matching articles is not zero, and oress <Enter>.’ When 
you press <Enter>, the system processes the query on the query line, and displays summaries of the 


Sif there are two numbers in front of each filter line, as is the case in Figure 2-2, the number before the "/" is the number of 
matching articles. The second number is the budget for that filter line; budgets will be discussed shortly. 


8 none of the filter lines appear brighter than the rest, press <Home> and adjust the brightness and contrast controls on 
your PC until the first filter line appears brighter than the rest. 


7 none of the filter lines have any matching articles, turn to the Appendix on trouble-shooting. 
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articles that match the query. The summary window is described in the next subsection. If this is your 
first time using the system, turn to the next subsection after you have pressed <Enter>. 


Because disk space and memory «are limited. the system does not save all matching articles 
permanently. When the system runs out of space, it deietes old articles to make rootn for new ones. 
You can teil the system how many matching articles you would like to keep for each filter line by 
specifying a budaqet for each line. If his is your first time using the system, press F2 to see the filter 
list; then press A-S to display the budgets if they are not visible. For each filter line, the system will try 
to keep at feast as many articles as the budget indicates, and perhaps more if there is encugh room. 
You can change the budget of any filter line by selecting that filter line, and pressing ‘>’ to increase 
the budget. or ‘<’’ to decrease it. 


When the system needs to delete an article to make room for a new one, it will first atternpt to delete 
cne from a filter line that is “over buciget’’. If several lines are over budget, an article wil’ be deleted 
from the last such line in the fitter. If all the filter lines are within their budgets, an article will be 
deleted from the last line in the filter that has matching articles. Because the system deletes articles 
from the bettom of tne filter first, you should arrange your filter so that the topics that interest you 
most appear near the top. You can rearrange the lines in the filter by pressing A-U (or A-N) to move 
the selected line up (or duwn) in the filter. This is better than deleting the line and re-inserting it 
elsewhere, because when you delete the line, articles that match only that line will be deleted. 


To find out what you can do in the filter window, press F2 (to see the filter window), and press / to see 
the corresponding command menu (¢3e Figure 2-2). You can execute any command in the menu by 
selecting it {using | and 7) and pressing <Enter>, or you can use the shorthand keys. Most cf the 
command names are self-explanatery; if this is your first time using the system, please go anead and 
try out the various commands. The commands are briefly explained below, with more detail about 
several of the commands below. 

» DO NGTHING (with shorthand <Esc>) — this command removes the menu. 

® SHOW WINDOW SELECTION MENU (F3) — this command shows the window selection menu; itis 
listed primarily to remine you of the shorthand key, F3. 

® SHOW SUMMARIES (Enter) -— this command shows brief summaries of all articles matching the 
current query that are saved cn disk. 

e SHOW REMOTE SUMMARIES (Control-Enter) — this command will send the query to our New York 
Times database and show brief summaries cf all articles matching the current query that are 
found in the data at MIT. 

@ SHOW FIRST ARTICLE (A-R) -— this command display the first article on disk that matches the 
current fiiter line. 

@ DELETE ALL ARTICLES IN LiST (A-K) —- this command deletes al! the articles on the disk that match 
the current filter line. Articles that match more than one line are not removed. This command 
wil ask for confirmation first. 

* PRINT ALL ARTICLES IN LIST (A-A) — this command prints all the articies that match the current 
filter line. 

@ CHANCE BUDGET OF CURRENT LINE (A-B) — this command puts the cursor in the budget fieid of 
the current filter fine and lets you cnange the budget. This command requires you to press 
<Enter> when you have finished entering the budget. 
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@ INSERT A NEW LINE (A-1) — this command inserts a new filter line, puts the cursor in it, and lets 
you edit the new line. This command requires you to press <Enter> when you have finished 
entering the filter line. 

© REMOVE CURRENT LINE (A-W) -- this command removes the current line from the filter list and 
deletes all matching articles. 

® MOVE CURRENT LINE UP (A-U) -—- this command moves the current filter line up in the filter list. 
See the proceding paragraph abeut filter Ine priority. 

© MOVE CURRENT LINE DOWN (A-D) -— this command moves the current filter line down in the filter 
list. See ine preceding paragraph about filter line priority. 

© TURN BEE®-ON-ARRIVAL ON/OFF (A-1) — this command toggles the feature that rings the bell 
upon arrival of an article matching the current filter line. This feature is described below. 

® TURN PRINT-ON-ARRIVAL ON/OFF (A-2) — this command tcygles the feature that prints all articles 
that match the current filter line upon arrival. This feature is described below. 

@ EXIT TO DOS (A-X) — use this command if you want to turn off the PC or if you want to use the 
PC for something else. This command requires confirmaticn. 


The SHOW SUMMARIES Command, with shorthand <Enter>®, instructs the system to process the query’ 
on the query line. Usually, the query line contains a copy of the current filter line. However, you can 
submit any query vou like by editing the query line before you press <Enter>.2 The query lanquage is 
described in Section 4. Note that while any valid query is permitted as a ‘ilter line, you can /ocally 
process only queriss that contain only words and phrases that occur in the filter. 


Queries which contain words or phrases which do not alreaciy appear in your filter will be 
automatically submitted to the remote database if the program was started with the -d option. Ifa 
query is not specific enough to process at the remote database, the program will, if possible, a menu 
of terms which may be added to the query in orde: to process the query remotely. You may choose a 
term from the menu, or select DO NOTHING to cancel the query (see Figure 2-5). 

A query which can be answered locaily (on your PC} may be submitted to th= remote database: select 
SHOW SUMMARIES FROM REMOTE SYSTEM from the inenu, or press <C-Enter> instead of <Enter>. 

You can custemize the filter by adding and removing lines, by re-ordering lines, and by changing their 
budgets (see Section 4 —- The Query Language). To add a new line to the filter, select a line at the 
point where you want to insert the new line, and ¢slect the INSEHT A NEW LIN command or press (A-1). 
The system will create a new filter line, containing a copy of the query fine and place the cursor in it. 
You can use the edit keys to eclit the new filter line if you wish. After editing the new filter line, press 
the <Enter> key to install it in the filter. If you change your mind and you decide that you do not want 
to add a line after all, press <Esc>. 

When you de/ete a filter line, the matching articles are also deleted.'° For this reason, the REMOVE 
CURRENT LINE (A-W) command requires confirmaticn. 


Since <Enter> is also used to initiate processing on menus, it can only be used as shorthand when there is no menu on the 
screen, 


4 he editing keys are described in Appendix V.3 — Editing Keys. 


10. . : ‘ 
“Except for articles that match one or more other lines as well. 
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ype: ny 
(subject: briefing) 
(subject: findigest) 
(subject: business digest) 
(subject: wall street) 
(subject: patents or technology) 
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The receiver is running on port 1 
Welcome to the MIT Community Information System - Type Fl for help 


Figure 2-3: The Filter Window with the Remote Query Routing Menu 


You can ‘mark’ a filter line so that the system will ring the bell when a matching article arrives. This is 
called “beep-on-arrival’’, and you can turn it on and off (for the selected filter line) by pressing A-1. 
Filter lines that have ‘“‘beep-on-arrival”’ set are identified by a musical note in the margin. You can 
elso mark a filter line so that the system will print all articles matching that line as they arrive. This is 
called ‘‘print-on-arrival’’, and you can turn it on and off (for the selected filter line) by pressing A-2. 
Filter lines that have “print-on-arrival” set are identified by the symbol Pt in the margin. If a line has 
both “beep” and “print” set, only the Pt symbol appears. 


The last line of the filter, displayed as an asterisk (*), is not really a filter line; it matches every article 
on the disk, and the number of articles matching it indicates how many articles are on the disk. The 
buaget of this line is called the system budget, and it indicates the maximum number of articles that 
the system will keep. You can change the system budget just as you change the budget of a filter line, 
by pressing ‘>’ or ‘<’ or by executing the command CHANGE BUDGET OF CURRENT LINE. If you have a 
kKard disk, you can limit the size of the \news directory by setting the system budget to, say, 100 
articles. The system budget is limited by the amount of free memory: when the system runs out of 
memory, it reduces the system budget accordingly. 


10 
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2.2 — The Summary Window 


3 
mmaug 20, 12:22 (41 Lines) Urgent Financial 
NEW YORK (AF) _ The stock market edged upward in an erratic 
session today, faced with new evidence of sluggishness in the 
economy. 
aug 19, 12:20 (47 lines) Urgent (Financial) (not read) 
NEW YORE (AF) _ The stock market moved low -e= 
blue chip stocks sported gains. 


The rece on port i 
Welcome to the MIT Community Information System - Type Fi for help 


Figure 2-4: The Summary Window and its Command Menu 


The summary window (see Figure 2-4) contains summaries of the articles that match a particular 
query or filter line. If this is your first time using the system, press F4 to see the summary window. 


Each article summary is preceded by a highlighted line containing: 

e the date (and time) of the article, 

e the number of lines in the article, 

e the priority of the article, and 

e the general subject area of the article. 
If the article has not yet been displayed, the header line also contains the words (not read). The 
header fine is followed by a brief “summary” of the article.'' The summa:ies are listed in reverse 
chronological order, i.e. the summary of the most recent article is listed first. 


The arrow to the left of the summaries points to the selected summary. You can select any summary 
in the summary window using the scroll keys.'? 


We do not employ someone to read the articles and write summaries. Instead, the system automatically extracts the first 
sentence of each article to display as the summary. !n most news articles, the first sentence provides a reasonably good 
summary. Sometimes, as you will discover, it doesn’t. And sometimes our automatic procedure for finding the first sentence 
doesn't work. 

12 When you use the scroll keys, the system will select a different summary if this is necessary to ensure that the arrow 
remains visible on the screen. 
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To learn what you can do in the summary window, press / to see the command menu (see Figure 
2-4). The command menu contains the following commands: 

® DO NOTHING (with shorthand <isc¢>) --- this command removes the menu. 

© SHOW WINDOW SELECTION MENU (F3) — this command shows the window selection menu: it Is 
listed primarily to remind you of the shorthand key, F3. 

© SHOW CURRENT ARTICLE (A-R) -— use this commend if you wish to read the article corresponding 
to the selected summary. If this is your first time using the system, you should select this 
command, press <Enter, and turn to the next subsection. 

® DELETE CURRENT ARTICLE (A-D) —- this conmand deletes the article corresponding to the 
selected summary. It does not ask for confirmation. 

Note: Articles which have been received from the remote system can rot be 
deleted. 

@ DELETE ALL ARTICLES IN LIST (A-IX) -— this command deletes all the articles whose summaries are 
in the summary window. It will ask for confirmation first. The number of articles in the summary 
window is listed on the status line. 

© PRINT CURRENT ARTICLE (A-P) — this command prints the article corresponding to ihe selected 
summary. it works only if your PC is equipped with a printer and the printer is turned on. 

© PRINT ALL ARTICLES IN LIST (A-A) -— this command prints ali the articles whose summaries are in 
ihe summary window. The number of articles in the surnmary window is listed on the status 


line. 
Note: Remote articles cannot be printed from the summary window. To print a 
remote article, retrieve the article (using the SHOW CURRENT ARTICLE Command), 
and print it from the article window (as described in Section 2.3). 
© EXIT TO DOS (A-X) — use this command if you want to turn off the PC or if you want to use the 


PC for something else. This command requires confirmation. 


‘iote: The summary window always contains the summaries from the last query processed. Thus, 
even if you change the query line and press F4 again, the contents of the summary window wil! remain 
the same. The following two commands, which are iisted in Section 2.1 — The Filter Window, are the 
waly ones that create a new list of summaries: 

@ SHOW SUMMARIES 

® SHOW FIRST ARTICLE 

® SHOW REMOTE SUMMARIES 
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2.3— The Article Window 


ug 20, 12:43 


type: AF Copyright 1986 The Associated Fress 
priority: Urgent 
date: 08-20-86 1222EDT 
category: Financial 
subject: FM Wall Street Noon 
text: = 
NEW YORK (AP) _ The stock market ed 
session today, faced with new evidence of 
economy. 
The Dow Jones average of 30 industr FS 
noontime on Wall Street. 
Gainers outnumbered losers by about 
of New York Stock Exchange-listed issues. 
Before the opening, the Commerce De fF 
housing starts dropped 1.8 percent last mof¥€ 
considered an indicator of future construc 
declined. 
The housing starts figure has now fallen for three consecutive 
months, something it had not done since 19781. 
Housing has been one of the few bright spots in the economy this 


Welcome to the MIT Community Information System - Type Fl for help 


Figure 2-5: The Article Window and its Command Menu 


The article window (see Figure 2-5) is used to display articles. You can move up and down through 
the article using the scroll keys.'* If this is your first time using the system, press F6 to see the article 
window. 

Most articles contain several words that matched your filter. The first occurrence of each such word 
is highlighted, so you can scan an article quickly and determine why it matched the filter.'* This is 
useful because filter lines sometimes match out of context, filtering in articles that do not interest you 
at all. If a particular filter line matches a lot of articles that do not interest you, you may wish to make 
that filter line more ‘specific’ — this is explained in Section 4. 

To find out what you can do in the article window, press F6 (to see the article window), and press / to 
see the corresponding command menu (see Figure 2-5). 

SHOW NEXT ARTICLE is probably the most useful command. It instructs the system to display the article 
corresponding to the next summary in the summary window. If there are no more articles, the system 
puts a message in the message area, and displays the filter window. 

The CommInS software remembers which articles it has displayed. If you don’t want to see the same 
article twice, you can use the command SHOW NEXT UNREAD ARTICLE instead Of SHOW NEXT ARTICLE. 


13 pgpn>, <PgUp>, <Home>, <End>, ete. 


14 There is no highlighting in articles received from the remote database. 
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When you have read an article, you can delete it (to make room for new articles). Depending on what 
you want to do next, you can use the command DELETE, THEN SHOW NEXT ARTICLE, the command 
DELETE, THEN SHOW NEXT UNREAD (ARTICLE), or the conmmand DELETE, THEN SHOW SUMMARIES. 
Note: Remote atticles cannot be deleted. 

lf your PC is equipped with a printer, you can print the article using the command PRINT CURRENT 
ARTICLE. IFonly a portion of a remote article has been received when a print command is issued, only 
that portion will be printed; in order to ensure that the complete article has been received before 
printing, wait for the ** End of Article ** line to appear at the end of the articie. 


As always, ycu can use the command EXIT To DOS if you want to turn off the PC or if you want to use 
the PC for something else. 


Note for first-time users: 

If this is your first time using the system, we recommend that you: 

e turn to Section 3 —- Databases and Services, and skim it to learn about the information 
services that are available through the Boston ConimIns; 

@skim Section 4 — The Query Language, to find cut how to put together a news filter 
that filters in the information you are interested in; 

@ after that, turn back to the beginning of this section (Section 2), reac! the parts that you 
were asked to skip on first reading, and try out all the differant commands. 
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2.4— The Diagnostic Window 


aug 20, 12:49 


The system has been running since aug 2 
An article was last received at aug 
Aan article was last accepted at aug 2 


Articles broadcast since system startup: 
Articles received: 

Articles with unknown keys: 

Articles matching the filter: 

Articles accepted: 

Articles presently on the disk: 

Articles currently in print queue: 


Unframed packets: 

Framed packets: 

Checksum errors: 

Intact packets: 

Duplications: 

Accepted: 

Mem: 323608, Rfrk: 904, Kfrk: 210, Rrevfrk: 946, Rmtfrk: 608, Cfrk: 194 


4 category: news) (priority: urgent |! bulletin | flash) 
Article matched: wang or "data general" or "digital equipment" or “analog device 


Figure 2-6: The Diagnostic Window and its Command Menu 


The diagnostic window contains information about the operation of the Boston Commins software. 
This information is updated continually. If your system is working correctly, you should have no need 
for this window at all. If this is your first time using the system, press F8 to see the diagnostic window. 


In the Boston ComminS radio transmissions, each article is divided into “packets’’ that are 
transmitted separately. Each packet is ‘checksummed’ to permit error detection, and broadcast twice 
to permit error recovery. The CommlnS software receives packets, verifies the checksum, and 
discards duplicate packets. The most important indicator of system performance is the number of 
“intact packets” received. During normal operation, the number of ‘intact packets” received should 
be increasing steadily, at a rate of about three per second, occasionally interrupted by brief pauses 
that are followed by rapid catching up. If the number of “intact packets” is not increasing, turn to the 
trouble-shooting guide in Appendix Ill. 


All “intact packets” are '‘accepted”’,, unless they are “duplications” of packets received earlier. Since 
every packet is transmitted twice, the number of “‘duplications’' should be approximately equal to the 
number of ‘‘accepted” packets. 

If a packet is “unframed”, or contains a ‘“‘checksum error’, itis not received ‘intact’. These numbers 
are an indication of reception quality. If your receiver is functioning well, the number of “unframed” 


16 


USING THE COMMINS SOFTWARE COMMINS USER'S MANUAL 


packets and ‘checksum errors’ should be very small. probably less than ten per day.'° When the 
radio station is off the air (usually from 2 am to 6 am) the number of bad packets will increase. 


You can get a sense of the percentage of articles that actually match your filter by comparing the 
number of “articles matching the filter” with the number of “articles broadcast since system startup”. 
The number of matching articles that are actually written to the disk is listed as “Articles accepted”, 
The number of “Articles presently on cisk”’ is the number of articles on the disk. 
You may reset all of the statistics counters by selecting the RESET COUNTERS TO ZERO (A-0) command. 
For legal and policy reasons, all our information broadcasts are digitally encrypted. Different kinds of 
information are encrypted using different keys. The software distributed for this experiment contains 
keys for the New York Times and AP articles, as well as for system announcements. Articles that are 
intended for a limited audience (for example, personal mail) are encrypted using keys that are not 
istributed to the general public; when such articles are received, they are counted as “articles with 
unknown keys”. 
If you instruct the system to print one or more articles, in the background, the number of ‘Articles 
currently in print queue” indicates how many articles remain to be printed. You can stop printing and 
clear the print queue at any time using the shorthand key A-Q. 
The bottom fine in the Diagnostic window indicates the amount of free memory, and the amount cf 
unused stack space in each of the ‘forks’ (internal processes) of the program. © Mem is the total 
amount of memory that is not allocated. Memory is allocated for each filter line, and for each article 
en the disk. 
Rfrk is the ammount of unused stack spece in the receiver fork. The receiver fork receives data, cnecks 
packets, assembles them inio articles, decrypts the articles, matches them against the filter, and 
writes new iiiformation to disk. 
Kirk is the smount of unused stack space in the keyboard fork. The keyboard fork processes all 
keystrokes and Commands. 
Cirk is the amount of unused space in the clock fork. The clock fork is responsible for periodic 
processing, 3uch as updating the clock in the upper right corner of the screen. 


Rmtfrk is tha amount of unused space in the remote processing fork. The remote fork manages 
communications with the remote datcbase server. This will only appear if tne duplex system is 
selected when ihe CIS program ts started. 

Racvirk is the amount of unused space in the remote receiver fork. This ferk receives and processes 
information from the remote database server. This will only appear if the duplex system is selecied 
when the CIS program is started. 


15. : : - ~ . 
ihere will usually be at least one “unframed” packet, because when you start up the Boston Commins prograin, odds are 


that it will receive the end of a packet before it begins to receive whole packets. 


This information is provided primarily tor the system implementors; ihere are no “user-serviceable paris’ within the 
Boston ComminS software. However, if the amount of free memory gets very small funder 100 for the forks, under [000 for the 
free memory) you may encounter unexpected problems. This should not happen during normal operation cf the system. 
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2.5 — The Options Window 


aug 20, 12:42 


The receiver is on 

Budgets are off 

Receiver is on port 1, modem on port 2 
Frint queue length: 0 articles 
Frinting on IBM printer in background 


s 
Turn receiver on/off 


e receiver is running on por 
Welcome to the MIT Community Information System - Type Fi for help 


Figure 2-7: The Options Window and its Command Menu 


The options window shows the setting of various controls that you can change. If this is your first 
time using the system, press F10 to see the options window. 

e The first line in the options window indicates whether the receiver is on or off. You can turn the 
receiver on or off with the command TURN RECEIVER ON/OFF, or with the shorthand A-O. When 
you shut the receiver off, the system will respond to your commands more promptly, because it 
won't be writing articles to the disk. On the other hand, you won't receive any new articles. If 
you decide to turn the receiver off so you can read articles without being interrupted, don't 
forget to turn the receiver back on when you’ re done. 

e Line two of the options window indicates whether or not the budgets are being displayed in the 
filter window. You can turn the budget display on or off with the command TURN BUDGET 
DISPLAY ON/OFF, or with the shorthand A-S. 

e Line three indicates whether the program is listening for articles on port 1 or on port 2. The 
modem which allows communication with a remote database server is assumed to be on the 
other port. If you have two serial ports, you can switch the program io the other port with the 
command SWAP MODEM/RECEIVER PORTS (or with the shorthand A-V).'” 

e Line four indicates how many articles are waiting to be printed. To stop printing and empty the 
print queue, use the command STOP PRINTING AND EMPTY QUEUE or press A-Q. 


you can also select a port when you start up the program: see Appendix 1.5.1 — Starting the Commins Program. 
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e Line five indicates whether the prouram is expecting to print articles in the foreground or 
background. Background printing is more convenient because it allows other commands to be 
processed concurrently. However, the CIS program is designed to print in background on IBM . 
Graphics printers only. In order to use ower orinters, select the PRINT FOREGROUND Command 
from the menu. 


Note that even though this command menu is only available in the options window, the shorthand 
keys described here may be pressed at any time. 
There are several additional commands available in the menu. 

@ BLANK THE SCREEN (A-Y) Causes the screen to become completely blank unti! any key is 
pressed. This may be particularly useful in conjunction with multi-pracessing systems such as 
DesqView (TM) or Double-Dos (TM) which allow the CIS program te operate in the background 
while other programs are running on the computer. 

® IDLE THE SCREEN (A-C) Similar to BLANK THE SCREEN, this command causes a message to be 
displayed on the screen. The message is displayed in different places on the screen every few 
seconds, so as not to permanently burn the phosphors in the display. 

© HANGUP CONNECTION (A-H) Terminates any conr:ection to a remote database. This frees the 
database server for other users, and hangs up the telephone connection. 
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Section 3 — Databases and Services 


The Boston Commins provides you with access to two major databases: 

e the text of the New York limes, and 

@ the Associated Press (AP) news wire. 
The New York Times service includes the complete text of the articles that appear in that newspaper. 
The AP service provides articles on a wide variety of topics. Because the New York Times is a New 
York paper, it does not carry local news for the Boston area. However, the AP service provides 
extensive Boston and New England coverage. 
The New York Times and AP databases are founded on different philosophies. The New York Times 
provides highly polished and reacdabie news stories, corresponding to the printed version of the New 
York Times. Developing news stories are usually updated once a day by their editois. The AP 
service, on the other hand, provides up to the minute reports on breaking news stories, as well as 
corrections. updates, and occasicnal retractions of previous stories. Thus, you can expect to get 
different kinds of informatior: from tnese different sources. 


3.1— Fields 

All news articles follow the same standard format: an article consists of several fields, including the 
TEXT field. Section 4 describes how to take advantage of the information in the various fields when 
you put together your personal news ‘ilter. 

The set of fields is fixed; the use of the various fields is described below. For an example of how the 
fields are used, just look at any article. 


TYPE The TYPE field of an article identifies the source of the article. There are three tyoes of 
articles: "nyt" (New York Times), "ap" (Associated Press), and "cis" (announcements 
from the Bastion Community Information System). As we expand our information 
services, new article types may appear. 

DATE The DATE field indicaies the date and time at which article was written. 

CATEGORY The CATEGORY field identifies the general subject area of an article. The categories used 
oy the New York Times ard AP editors are described in the next subsection. 

AUTHOR The AUTHOR ficld identifies the author of an article. This field is sometimes left blank by 
the originating information source. Occasionally, the author of an article is identified by a 
by-line in the TEXT fieid of the article. 

PRIORITY The PRICRITY field iridicates the priarity of the article, as classified by the originating 
information source. The PRIORITY ficld of an article contains one the following words or 


phrases: 

flash the highest priority; it is seldom used 

bulletin the priority level of prime news; it is also used fcr corrections, 
updates, and occasional retractions of previous stcries 

urgent the priority level of important news 

regular the priority level of routine news 
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deferred the lowest priority level; used for delayed sending of a completed 


story 

Weekday advance material for a future weekday 
Sunday advance material for a future Sunday 
POeruUns reruns 

SUBJECT The supBuecr field contains a subject identifier that is assigned by the originating 
information source. Certain subject identifiers are used consistently; some of these are 
listed in Section 3.3. Some articles are actually listings of upcoming articles, and they 
give the subject identifier for each upcoming article (for example, "REAGAN SPEECH"). 
If you are interested in sucin an article, add a filter line of the form (subject: "reagan 
speech") to your filter and your system will catch the article. 

TITLE The TITLE field contains the title of the article, if any. Most articles do not have titles. 

TEXT The TExT field contains the text of the article itself. 


3.2 — Categories 

As will be explained in Section 4 — The Query Language, a filter lime or query of the form 
(category: <something>) matches articles whose CATEGORY field cortains <something>. The 
CATEGORY field is very useful, because the New York Times and AP editers put every article in an 
appropriate category. The following is a list of the categories used. Unfortunately, the categories do 


tend to change with time, so this list is not complete. 


Advisories 
Domestic 
Washington News 


International News 


State and Regiona} News 


Financial 


Features 
Lifestyle 
Entertainment and Culture 


Racing Results and Entries 
Sports 

Individual Sports Scores 
Commentary 

Travel 

Multiple Categories 


Listing of the subject lines of stories on the news wire 
Domestic news, except for news fram Washington D.C, 


News concerning naticnal politics, the United States 
government, actions of ihe President, and congressional 
decisions 


News about foreign events, iricluding articles originating at the 
United Nations headquarters 

News concerning the local Massachusetts area 

Business news, financial indicators, and some stock market 
information 

Feature stories 

Social news 

Articles on entertainment, culture, and ihe arts, including reviews 
of movies, plays, books, and television programs 

Uscoming herse races as well as results 

Sports features and scores 

Selected box scores 

Editorials and columns 

Travel information and human interest stories involving travel 
Articles consisting of segments that belong in different 
categories; frequently used for announcements of upcoming 
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articles 
Presidential Flection Election coverage (when applicable) 


3.3— Subjects 

Our information sources provide a variety of information, such as news summaries, on a regular basis. 
Information of this kind is identified using the SUBJECT field; for example, the query (subject: 
newssummary) matches the New York Times news summary, as well as various kinds of AP news 
summaries. In the descriptions below, (NYT) refers to material from the New York Times, (AP) refers 
to material from the Associated Press. The following subject identifiers are used consistently by our 
information sources, but note that they do change occasionally and new subjects may be added for 
events occurring at a particular time, i.e. elections, sport seasons, etc.: 


anderson column Dave Anderson’s column (NYT) 

architecture Articles about architecture (NYT) 

arts News about the arts (AP) 

60 minute gourmet What to do for dinner in one nour (NYT) 

baker column Russell Baker's editorial (NYT) 

oba American League Baseball (AP) 

gba National League Baseball (AP) 

bbo Combined League Baseball stories (AP) 

yerkow column Sports commentary (NYT) 

yestsellers Hardcover bestseller list (NYT) 

biztalk Business news summaries (NYT) 

bizweek Weekly business story (NYT) 

bke College Basketball (AP) 

sonds Bond prices (AP) 

vock review Reviews of new books (NYT) 

“ook talk Column about books (NYT) 

box* Box scores of baseball games (AP) 

briefing Briefing on washington news and political events (NYT) 

uroadway Stories about Broadway onenings/closings/reviews (NYT) 

business digest Business news digest (AP) 

ausiness highlights Business news highlights (AP) 

puSiness mirror Column on business (AP} 

calendar Calendar of political events or of crafts, performing arts, and openings in 
the New Englarid area (AP) 

candidates Close-up on political candidates (when applicacta) (NYT) 

capitol ideas Column from Washington (AP) 

careers Features on interesting careers (NYT) 

cheese eggs Cheese and egg prices (AP) 

chess Articles on chess (NYT) 

claiborne Cooking with Craig Claiborne (NYT) 
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colleges 
coldumn 
comput* 


CONgress 


consumer column 


consumer rates 
Court 

credit 

credit rates 
databank 
deaths 

digest briefs 
dollar 
economy 

eco 

edit* 
editorial rndp 
education 
elections 
extendeds 
Fashion* 

fhe 

fbn 

Fbo 

finbriefs 
Findigest 


followups 
food fitness 
football ya 
forecasts 


foreign affairs 


foreign briefs 


foreign eachange 


Frontpage 
global temps 
gov finances 
hkn 

hko 

homevideo 
indexes 
industry news 
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Stories on college sports (NYT) 

Columns from the New York Times 

Various columns about computers, computing etc. (NYT) 
Stories on Congress’ actions (NYT) 

Consumer advocacy column (NYT) 
Consumer credit rates (NYT) 
Important court rulings (NYT) 

Reports on commercial credit markets (NYT) 

Present commercial credit rates (NYT) 

National economic indicators (NYT) 

Obituaries {AP) 

Well-edited news summaries (AP) 

information on the exchange rates (AP) 

Information and articles about the US economy (AP) 
Various economic stories (NYT) 

Editorials from the New York Times 

Editorials from New England papers (AP) 
Stories on =ducation (NYT) 

Various election results (when applicable) (AP) 
Three-day extended weather forecasts (AP) 

Articles aticut fashion (NYT) 

College football (AP) 
Professional footbail (National league) (AP) 
Combined! igague football stories (AP) 

Collections of short news items about business and finance (NYT) 
A daily digest of top financiai news from the New York Times. This digest 
is identical \o the business cigest on the front page of the New York Times 
business section. 

Follow up on the news (NYT) 

Nutrition articles (NYT) 

Football question column (NYT) 
Forecasts for around the country (AP) 
Foreign affsirs column (NYT) 

Foreign news briefs (NYT) 

Foreign exchange rates (AP) 

A daily description of the layout of the front page of the New York Times 
Temperatures arouid the werid (AP) 

Figures on Government spending and debt (AP) 
National Hockey (AP) 

American Leaque Hockey (AP) 

Recent home videotape releases (NYT) 

New York and American Stock Exchange indexes (AP) 
Business news briefs (AP) 
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jnterview 
investing 


kitchen 


kisselgoflt dance 


kremlia 

lewis column 
Ipga 

mail order 
market 
marketplace 
mass digest 
mass* lottery 
inass* news* 
mass* nightcap 
matchups 
megabucks 
mortgage 
movie* 


movie notes 
movie review 
names news 
nasdaq 

news digest 
news summary 


obits 

oly 

on language 
outdoors 
patents 
paperbacks 
people 


personal finance 
personal nealth 


pga 
pop 


practical traveler 


produce 
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Various interviews (AP) 

Various stories on investments (NYT) 

A column on kitchen equipment (NYT) 

A weekly column on dance (NYT) 

Political events in Russia (NYT) 

Anthony Lewis’ column (NYT) 

Ladies’ professional golf stories (AP) 

Mail order suggestions (NYT) 

A daily report on the stock market (NYT) 

Wall street news (NYT) 

Massachusetis news digest (AP) 

Massachusetts daily lottery results (AP) 

Massachusetts News summaries (AP) 
Massachusetts News summaries (AP) 

Pre-game analysis of upcoming sporting events (1/YT) 

Massacnusetts Megabucks lottery stories (AP) 

Articles about mortgages (NYT) 

Movie reviews and features about movies, including columns by Maslin 
and Canby (NYT) 

Movie column (NYT) 

Movie reviews (NYT) 

People in the news (AP) 

Selected over-the-counter stock prices (AP) 

A capsule summary of iop national news stories from the AP. 

A capsule summary of top news stariés from either the AP or the New York 
Times. The New York Times naws summary somes out once a day around 
midnight, and is identical to the news summary ihat appears on the first 
page of the B section cf the printed paper. Use the query (type: nyt) 
(subject: newssummary) for this summary. The AP summarizes local 
news many times a day. 

Obituaries (NYT) 

Olympics coverage (AP) 

Column by William Safire on the English language (NYT) 

Colurnn on outdoor activities (NYT) 

Patents of special interest that have recentiy issued (NYT) 

Paperback bestseller list (NYT) 

Column on people in the news (AP} 

Coiumn on personal finance (NYT) 

Column on persona! health (NYT) 

Professional golf stories (AP) 

Articles cn popular music (NYT) 

Travel advice (NYT) 

Boston wholesale prodtice prices (AP) 


NO 
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prospects Financial prospects for particular business sectors (NYT) 
ques tionbox Sports questions and answers (NYT) 

quotes Notable quotations (AP) 

racing Horse tacing news (NYT) 

records Recent classical record releases (NYT) 

reston column James Reston's column (NYT) 

russell art Johu Russell’s art column (NYT) 

safire column Column by William Safire that is not "On Language” (NYT) 
science q a Science questions and answers (NYT) 

science watch Short summaries of recent scientific news (NYT) 

zcotus Supreme Court (of the United States) news (AP) 
scouting Stories on sports players (NYT) 

silk column Financial commentary by Leonard Silk (NYT) 

ski Column on skiing (NYT) 

<dorts briefs Brief stories about sports (AP) 

sports minute Latest sports stories (AP) 

sports watch Time tables for sporting events (AP) 

stocks Articles on the stock market (NY1T) 

tabletalk Food column (NYT) 

tech* Reports on new and interesting technologies (NYT) 
celerate Interest rates, including T-bills, Eurodollar, Federal discount rate etc. (AP) 
theater Articles about and reviews of the theater (NYT) 
transactions New York Stock Exchange trading valume (AP) 

travel Various travel stories (AP) 

travel notes Vacation ideas (NYT) 

travelers forecast* Weather forecasts for selected cities (AP) 

iv review Reviews of upcoming television programs (NYT) 

Le tonight Tonight's TV programs; sent three days in advance (NYT) 
tv weekend Weekend television (NYT) 

vacation Vacation notes and ideas (NYT) 

yeacsey column Sports column (NYT) 

video Column on home videctanes (NYT) 

wall street Reports on Wall Street trading (AP) 

washington brief Short news items from Washington D.C. (AP) 

watch Upcoming business events to watch (NYT) 

wea temps Temperatures and weather from major cities around the country (AP) 
weatherpage Summary of weather around the country (NYT) 

wicker covumn Tom Wicker’s column (NY7T} 

wine* Column on wine (NYT) 
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3.4— Useful Queries 
In addition to the subject specifiers above, the following queries will provide you with useful 
information. 


beston vicinity forecast* Local weather forecast (AP) 


massachusetts daybook Newsworthy upcoming-events in Massachusetts (AP) 
ski conditions Ski conditions at alt local ski reagsts (AP) 
(title: week review) Artictes from the New York Times “week in review’’ section 


(subject: mass* digest) _ Latest Massachusetts news capstiies (AP) 
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Section 4— The Query Language 


The Commins sottware lets you describe articles that interest you using a simple language, called the 
query fanquaye. the query ianquage is used primarily for filter lines, bul you can also type queries 
directly into the query line. As described in Section 2, the system uses your filter to determine which 
articles to save for you. Using the query language, you can tell the system what articles interest you, 
in terms of their contents. source, authas, subject. and a variety of other attrigsutes. In this section, we 
explain the query language, starting with the simpiest possible queries. 


The simplest possible query is a single word. Imagine, for example, that you are interested in all 
articles that contain the word "peace". The corresponding query is the word peace. If you are 
interested in all articies that contain the words "war" and "peace", the corresponding query could be 
war and peace,war & peace,orsimply war peace. Thus, you can combine two simple queries 
into a more specific query by neans of and, & or concatenation. 


Next, imagine that you are interested in all articles that mentioned the Susreme Court. You could use 
the query supreme court, but this query matches all articles that contain the words "supreme" and 
"court", regardless cf whather they appear consecutively. To indicate that the words "supreme" and 
"court" must appear consecutively as a phrase, simply put them in quotes: "Supreme Court". A 
phrase may contain any number of words. The remote system cannct handle phrases, therefore 
typing "new york mets” has the same effect as typing the three wcrds as explained in the 
preceding paragraph. 

Next, imagine that you are interested in all articles about computers, computing, computation, and so 
on. To catch ail these articles, use the query comput*: it matches all articles that contain one or 
more words beginning with the letters "comput". These queries are called stem queries, because 
they match any word that begins with a specified stem. There are two restrictions on stem queries: a 
stem query may not appear inside a pnrase, and the stem must be at Jeast lwo characters long. 


The following convention applies to all queries: uppercase and lowercase Iciters are considered the 
same, and ai! punctuation characters in articles are treated as spaces, except for apostrophes, which 
are ignored. the system will not accept queries that contain punctuation characters, except for 
hyphens, which are treated as spaces. Thus, fhe query rogers matches the following words: 
"rogers", "Rogers", "Roger’s", "Rogers’", anc so forth. The queries "space cadet" and 
"space-cadet" match the following phrases: “space-cadet", "Space Cade", etc. 

Next, imagine that you are interested in articles by a certain author, say Jobin Smith. You could use 
the query Smith, but it matches every article that contains the word "smith", regardless of the 
context in which it appears. To rule out all these extra articles, use the quevy (author: smith); it 
maiches all articles that have an AUTHOR field containing the word "smitn". Queries of this kind are 
called tield-specific queries; the possible fields (resides AUTHOR) are listed in Section 3.1. Other 
examples of field-specific queries include (subject: newssummary) and (type: cis). 

Above, we showed how to combine two queries into a more specific query by means of and, &, or 
concatenation. In combination with field-specific queries, this combining rule is very useful; for 
example, the query ibm (category: fiaancial) matches all articles that contain the word "ibm" 


and have a CATEGORY field containing the word "financial". 
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in some situations, the date of an article is important. The query language permits you to specify a 
date using a special format; dates are recognized when enclosed in square brackets with the special 
key word DATE. 

[dale jun 12 1986 | 
Dates may be specified as a nuinber of days in the past: 

[date -1] 
Dates may also be specified as ranges: 

[date jun 12 : jun 16] 
Mote that the year will default to the current year. 
The date on which an article was written appears in the "Gate" field of the article. For example, to 
find all articles containing the word juggling that appeared in yesterday’s New York Times, use the 
iollowing query: 

juggling & (type: nyt) & (date: [date -1]) 
Mueries issued to remote database servers must be narrowed to specific dates, i.e. (date: [date 
-30 : -1)], and sources,i.e. (type: nyt). The CIS program will assist in this by suggesting what 
sources and dates are available, based on information read in from the configuration file. 
The examples on the next page illustrate the different kinds of queries, and the various ways in which 
they can be combined using and, or and not. 
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The Query 


peace 
"War and Peace" 


compul* 


ski* 


wer and peace 
war & peace 
war peace 


war "and" peace 

war or peace 

war | peace 

not war 

~ war 

peace and (quiet or talks) 
(peace and quiet) or talks 


(subject: movie*) 


(author: sinith (not john 
J 


harvard (not (subject: footba?1)) 
harvard (subject: (not football)) 
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Matches Articles that... 


contain the word "peace" 
contain the phrase "war and peace" 


contain a word that begins with "comput", such 


as "computer", “computation” or 
"computability" 


..contain a word that begins with "ski", such as 


"ski", "skiing", "skid", "skin" or "skiascope" 


contain the words "war" and "peace". The three 


queries shown to the left are equivaient. 


..contain the words "war", "and", and "peace" 


..contain either the word "war" or the word 


"yeace". The two queries shown to the left are 
equivalent. 


..do not contain the word "war". The two Gueries 


shown to the left are equivalent. 


..contain the word "peace" and either the word 


"quiet" or the word "talks" 


..contain the words "peace" and "quiet" or the 


word "talks" 


have a SUBJECT field containing a word that 


begins with "movie" 


have an AUTHOR field containing the word 


“smith” but not the word "john" 


contain the word "harvard" but do not havea 


SUBJECT field containing the word "football". 
The two queries shown te the left are ecjuivalent. 


The following are some exainpies of invalid queries, along with the reasons why they are invalid: 


The Query 


"comput* languages" 
(author: (subject: smith)) 


Mr. Rogers’ neighborhood 
(topic: reagan) 


(a or (b) orc 


2g 


Is Invalid Because... 


.a stem query may not appear within a chrase 
..a field-specific query may not be nesied inside 


another field-specific query 


punctuation (such as pariads and apostrophes) 


cannot ve entered in queries 


TOPIC is nat a valid fieid name. The valid field 


names are listed in Section 3.1. 


..parentheses must be balanced 
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Appendix |— Getting Started 


important 


The Boston ComminS hatdware and software have bee designed for use with an IBM 
PC'™, XT™, or AT'™ personal computer with the following minima! configuration: 
@ a monochrome or graphics display card and monitor, 
@ version 2.1 or 3.1 of the MS DOS" operating system, or a covrespanding version of 
PC-DOS"™, 
@ one floppy disk drive, 
e 256 K (kilobytes) of RAM, and 
e one RS-232 serial port. 
@one 1200-baud modem to retrieve articles from our New York Times database 
(optional) 
The Boston CommiInS hardware and software may also work with 100-percent compatible 
machines made by other manufacturers, provided that they have at least the 
configuration listed above. 


Introduction 


This appendix explains how to unpack the equipment and how te start using the hardware and 
< oftware for the Boston CommIn&S. It covers the following topics: 

e unpacking the equipment, 

@ installing the hardware, 

a installing the software, 

e running the Comm!nS program, and 

e stopping the Commins program. 


Please read and follow these steps in order, even though you may have years of experience witn 
microcomputers and/or communications. 


1.1 — Unpacking the Equipment 
Ail the equipment, software and documentation for the Rosten ComminS is packaged together. Each 
package should contain the fcllawing: 
e One receiver (wrapped in bubble wrap) — an grey box with a signal strength meter, three 
connectors, and an M!T equipment tag 
®power suppiy (AC adaptor) — a black object with prongs that can be plugged into an 
ordinary outlet (110 volt AC) 
e One antenna — a flat, white ribbon cable in the shape of a targa "T", with a special connector 
at the bottom of the "T" 
© One RS-232 cable —- a gray, 20-foot cable with a 25-pin connector at one end and a “phono” 
plug at the other end 
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Antenna 


Receiver 


Power Cord 


20-foot RS-232 Cable 


Connector Panel on Personal Computer 


) off 


Figure [-1: Installation Diagram 


e One distribution disk —- a standard 5% inch (860K format) floppy disk, packed inside the 
user’s manual 

e One user’s manual — you're reading it. 
Piace the cantents of the distribution package on a table, and make sure you have received ali of the 
above items. If one or more items are missing, call the Boston CommInS ‘HOTLINE’ at 
(617)-253-0007. 
Please save the box and packing materials for when you return the equipment to us at the end of this 
experiment. 


1.2 — Installing the Hardware 

Note: Please read this section once bcfore you begin to put the equipment together. 

Positioning the Equipment 

The receiver, power supply, antenna, and cables can be arranged in any way that suits you, provided 
that they can be plugged into each other (see Figure |-1). Place the antenna near a window, 
preferably an the side of your building nearest Boston’s Back Bay neighborhood (the Prudential 
Tower, to be exact). Referring to Figure I-1, position the receiver so that (i) it can be plugged into the 
antenna, (ii) the 6-foot power cable can reach an ordinary outlet (110 volt AC) and (iii) the 20-foot 
RS-232 signal cable can reach your personal computer. 


Power 
Plug the power supply (AC adaptor) cable into an ordinary outlet (110 volt AC). Plug the other end of 
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the power cord into the matching Cconnactor on the receiver. 

RS-232 Cable 

Plug the gray “phono” plug at the end of the 20-foot RS 232 cable into the matching connector on 
the receiver. Then plug the 25-pin RS-232 connector at the other end of this cable into the RS-232 
serial port of your computer. For most installations, this description suffices. However, two unusual 
situations may apply to you: 

e if you have more than one RS-232 serial port on your personal computer, you must know which 
is port 1 and which is pert 2. Normally, the Commins software expects the receiver to be 
connected to port 1, but either port 1 or port 2 may be used. 

e If you have an IBM AT™ computer with a 9-pin serial port connector, you will need an adaptor 
cable tnat lets you connect the 25-pin RS-232 connector to the socket on the AT’s rear panel. 

e if amcdem is connected to either serial port one or two, the CIS preyram may be instructed to 
use it to retrieve information from a remote database server. 


Receiver 

Plug the antenna into the receiver. If you place the receiver near a window, be sure to protect it from 
rain and snow if you keep the window open. 

Antenna and Orientation 

Positioning the antenna properly is the most important part of installing the system. If the antenna is 
not in a good position, you may not get good reception. As discussed earlier, try to position the 
antenna near a window on the side of your building closest to Beston’s Back Bay. Our transmitter is 
located atop of the Prudential Building. 

Note that the antenna looks like a large "T" (about four feet wide) — kcep the top part of the T 
straight and taut. We have found that in mosi locations the best results are achieved when the top of 
the "T" is kent horizontal. While keeping the top of the antenna horizontal, rotate the antenna until 
you find the orientation that maximizes the reading on the recgiver’s signa’ strength meter. For best 
results, do not hold the antenna while you read the signai strength meter. Once you have found the 
orientation that maximizes the meter reading, fix the antenna in this position. 

If you are returning to this section because of poc: reception, try one of the following: 

e Tape the antenna to your window — remen:er to keep the top of the “T" fully extended — and 
check your reception. 

e Stand facing the Prudential Building and hold the antenna fully exter:ted between your hands. 
Now lay the fully extended antenna down, fix itin this position, and check your reception. 

e Instead of using the antenna supplied in the package, you can use another antenna; antennas 
designed for VHF TV will work very well. If the antenna does not have a plug that fits the socket 
on the receiver, connect it to the two screw terminals on the black connector (balun) provided 
with the anienna in the package. The antenna should be pcinted towards the Prudential 
building for best results. 


If neither of these suggestions help, call the Boston ComminS ‘HOTLINE’ at (617)-253-0007. 
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1.3— Installing the software 


Note; Before you install the software, make sure that you are using version 2.1 or 3.1 of the | 
MS-DOS™ operating system, or a corresponding version of PC-DOS"™, 
Locate the Distribution Disk in the distribution package. Use the DOS "DIR" command to list the 
directory of the Distribution Disk. The disk should contain four files: 

e CIS.EXE 

e FILTER.TXT 

e HELP.TXT 

@ CONFIG.TXT 
7he instructions for installing the software depend on whether you have a hard-disk drive, two floppy 
disk drives, or only one floppy disk drive. Determine which of the following three sections is 
appropriate, and follow the instructions in that section. 
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1.3.1 — Installing the Software on a Hard Disk 
1. Insert the distribution disk into drive A. 
2. Make the hard disk the default drive: 
C: <tnter> 
Most hard disk systems use drive C to refer to the hard disk. If you have multiple hard 
disks, or your disk is known by a different drive letler, replace C in the instructions by 
the drive of your choice. 
3. Build a directory for the Boston ComminS program, and change the current directory to be this 
new directory: 
mkdir \news <Enter> 
cd \news <Enter> 
Because the DOS file system limits the root directory to 112 files, the Boston 
CumminS data should be stcred in a subdirectory. We recommend using a directory 
cailed \news. 
4. Copy the ComminS files frem the distribution disk: 
copy a:*.* <Enter> 
This command will copy four files: CIS.EXE, FILTER.TXT, HELP.TXT and 
CONFIG.TXT. 
5. Remove the distribution disk from the floppy disk drive, and store it in a safe place. 
Keep the distribution disk as a backup. 
6. Start the Community Intormation System program: 
cis <Enter> 
7. Turn to Appendix 1.4 —- Running the ComminS Program. 
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1.3.2 -—— Installing the Software with Two Floppy Disk Drives 


1. 


ine) 


11. 


12. 


14. 


Take a blank disk that has been formatted with the /S option. 
If you do not have a blank system disk handy, format anew disk now. Make sure the 
new disk is not write protected: remove the piece of tape covering the write-protect 
notch on the side of the disk if necessary. 


. Label this blank system disk "Boston CommlnS Program". 


From now on, we will refer to this disk as the "program disk”. 


Take another blank disk, this one formatted without the /S cpiion. 
Use a disk formatted without the /S cption, because it has mure space for data 
storage. 


. Label this second blank disk "Boston ComminS Data". 


By keeping the data on a separate disk from the program, you will be able to store 
more information. From now on, we will refer to this disk as the "data disk". 


. Insert the distribution disk in drive A. 
. Insert the program disk in drive B. 


Copy the file CIS.EXE from the distribution disk onto the program disk: 
copy a:cis.exe b: <Enter> 
Remove the program disk from drive B, and insert the data disk in clrive B. 
Make drive B the default drive: 
b: <Enter> 


. Build a directory for the Boston CornminS data, and change ihe current directory to be this new 


directory: 
mkdir \news <Enter> 
cd \news <Enter> 
Because the DOS file system limits the root directory to 112 files, the Boston 
CommiInS data should be stored in a subdirectory. We recommend using a directory 
called \news. 
Copy the CommiInS text files from the distribution disk into the \naws directory: 
copy a:*.txt <Enter> 
This command will copy three files: FILTER.TXT, HELP.TXT and CGHFIG.TXT. 
Remove the distribution disk from floppy disk drive A, and store it in a safe place. 
Keep the distribution disk as a backup. 


. Insert the program disk tn drive A. 


When you cun the Commins program, the program disk should be in drive A, and the 
data disk in drive B. 
Start the Community information System program: 
a:cis <Enter> 
The program is on drive A, and the \news directory containing the data is on drive B. 


. Turn to Apperidix 1.4 — Running the CommInS rogram. 
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1.3.3 — Installing the Software with One Floppy Disk Drive 
1. Take a blank disk, formatted with the /S option. 
If you do not have a blank system disk handy, format a new disk now. Make sure the 
new disk is not write-protected: remove the piece of tape covering the write. protect 
notch on the side of the disk if necessary. 
2. Label the blank system disk "Boston CommtinS", 
From now on, we will refer to this disk as the "program disk". 
3. Insert the program disk in the floppy disk drive. 
4. Build a directory for the Boston CommiInS data, and change ihe current directory to be this new 
directory: 
mkdir \news 
<Enter> 
cd \news <Enter> 
Because the DOS file system limits the root directory to 112 files the Boston CoramInS 
data should be stored in a subdirectory. We recommend using a directory called 
\news. 
5. Copy the CommiInS files from the distribution disk: 
copy b:*.* <Enter> 
You will be asked to remove the program disk and insert the distribution disk. This 
command will copy four files: CIS.EXE, FILTER.TXT, HELP.TXT and CONFIG.TXT. 
You may need to swap the two disks several times. 
Remove the distribution disk from the floppy disk drive, and store it in a safe piace. 
Keep the distribution disk as a backup. 
7. Re-insert the program disk in the floppy disk drive. 
8. Start the Community Information System program: 
cis <Enter> 
9. Turn to Appendix 1.4 —- Running the ComminS Program. 


o 
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!1.4— Running the CommInS Program 

At this point, the Boston CommlnS program should be running on your PC. Normally, the program 
assumes the receiver is connected to port 1. If your receiver is connected to port 2, hold down the 
<Alt> key and press V to switch the system to port 2. 


You should now he “on the air". News articles received by the system will be stored in the \news 
directory. To verify that the system is working, press F8 and wait until the highlighted line at the top of 
the screen displays the words “Diagnostic Window". If the system is working, it should be receiving 
“intact packets” at a rate of about thrce packets per second. Find the number of “intact packets” on 
the screen: it is displayed five lines above the highlighted line near the bottom of the screen. The 
number should be increasing steadily, at a rate of about three per second, occasionally interrupted by 
brief pauses that are followed by rapic catching up. If this is the case, everything is working; please 
turn to Section 2 — Using the Comniins Software and follow the instructions for first-time users. 


if the number of intact packets is not changing, refer to the trouble-shooting guide in Appendix Ill. 


1.5— Starting and Stopping the ComminS Program 


1.5.1— Starting the Commins Proqram 
The procedure fer normal start-up depends on the hardware configuration of your personal 
computer: ; 

e If you have either a hard disk or a single floppy disk drive, use the cd command to change the 
current directory to the \news directory, and start the program by typing cis. 

e If you iiave two floppy disk drives, place the CommlInS program disk in drive A, the CommInS 
data disk in drive B. use the b: and cd commands to change the current directory to the \news 
directory on the data aisk, and start the program by typing a: cis. 

if your receiver is connected to port 2, you can use the " ~2" option to tell the program to listen to 
port 2 right from the start: 
cis -2 <Enter> 
or 
a:cis -2 <Enter> 
lf you want the avility to use a modem to retrieve information from remote databases, you must start 
the CIS program with the "-d” onticn te enable duplex operation: 
cis -d <Enter> 
or 
a:cis -d <Enter> 
You may configure the program to print articles in the foreground (necessary i* you do not have an 
IM Graphics printer) by specifying the "-p" option: 
cis -p <Enter> 
or 
a:cis -p <Enter> 


Of course, options may be combined, for example: 
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cis -2 -p <Fnter> 
or 
a:cis 2 -p <fPnter> 
When you start the CommlnS program, it begins to receive data immediately. You should verify this 
by pressing the F8 key and checking to see that tie number of “intact packets” is increasing. If the 
system is not receiving daia, refer to trouble-shooting guide in Appendix Hl. 


1.5.2 — Stopping the CommInS Program 

To stop the ComminS program, you should hold down the <Alt> key and press X, or execute the EXIT 
command that appears in every menu. This instructs the system to save tis article directory on the 
disk and return to DOS. 


Warning: 
Do not stop the ComminS program by turning off the power or by re-booting your PC. 
If you interrupt the orcgram in this way, the files used by the system may be left in an 
inconsistent state. ‘Vhen this happens, the program must be re-started using the " -r" 
option (described below). 


1.6 — Restarting after a Crash or Accidental Shutdawn 

If the hardware or software running the Boston ComminS fails or is inadvertently shut down without 
using the ExiT command, the files used by the systern may be lefi in an inconsistent state. Depending 
on the cause cf the problem, you may wish to consult the trouble-shooting guide in Appendix Ul. 


If the system crashes a: is accidentally shut down, you should reboot the DOS cperating system in 
one of the two standard ways — either (i) by turning your perscnal computer off for 20 seconds and 
turning it back on, er (ii) by simultaneously holding down the <Ctrl> and <Alt> keys and then pressing 
the <DeD key. We reccommend the latter method, to minimize wear of the conputer hardware. 


To restart the ComminS prograin, follow the instructions for narrnal start-cio in Appendix 1.5.1, but 
invoke the ComminS program with the" -r" option: 

cis -r <Enter> 

or, if you are using Port 2: 

Giiss 220 =r <Enter> 
The "  -r" option instructs the Commins program te re-build the “omminS directory file, 
CIS —- DIR. TXT, by reading ail the article files on the disk and comparing them with the filter in the filter 
file. During the rebuilding process, the system disnlays the names of the files as it reads them; when 
this is finished, the systern starts up as usual. Pecause of the large amount of disk reading and 
indexing that is required, the rebuilding process takes a large amount of time to execute. 
As always, the system should begin to receive data immediately. You should verify this by pressing 
the F8 key and checking to see that the number cf “intact packets” is incraasing. If the number of 
“intact packets” is not changing, refer to trouble-shooting guide in Appendix Il. 
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Appendix Il — Setting Up The Remote System 


Note: 

If you do not have a modem that is capable of using a 12GO baud communications, you 
cannot use the remote access feature of the Boston ComminS program. Please check 
that your modem has 1200 baud canabilities befcre continuing. 

If you have only one serial port, the program cannot listen to broadcast articles and 
access the New York Times database simultaneously. However, you can do one or the 
other at any time, provided that you Connect the modem or receiver to the serial port and 
swap the ports within the program. 


11.1 — Hayes Modems 
If you have a Hayes or Hayes compatible modem, the Boston Comm!nS software does not need any 
additional set up, beyond starting the program with the -d option. (Gee Appendix 1.5.1) 


il.2-- Non-Hayes Modem 

If your modem is not Hayes compatible you will have to first establish a connection to the remote 
server prior to issuing remote queries to the Boston ComminS software. The following procedure 
must be executed with a modem communications program: 

e Reset the modem to its initial state. 

e Set the modem for 1200 baud mocie, if applicable. 

e Dial the remote server at (617) 258-7161. If you get a busy signal, continue to attempt to make a 
connection. Once a connection is established, you should receive a ‘login’ prompt. tf you did 
not receive this prompt, you may not have a 1200 baud modem. Check your manual. 

® Exit your modem communications program, without severing the connection. 

e Enter the Boston Commins software with the -d option (See Appendix 1.5.1) 

® The soltware will check if the mocem is connected, prior to sending a query. 

e lf there is a provlem with the connection and the Boston ComminS program needs to redid the 
modem, you will have to exit the program and execute the above steps again. The program 
cannot reestablish a connection on non-Hayes or compatible modems. 

e NOTE: If you are running the Boston ComminsS software in the background, you do not have to 
exit the program each time to establish a modem connection. Simply make the connection with 
tha modem program with the Boston Cammins software in the background. 


If you are still having difficulties, contact the Boston ComminS HOTLINE’ at (617) 253-0C07. 
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Appendix Ill— Trouble-shooting Guide 

If you are having trouble installing or using the system, check this list of common problems, 
symptoms, and solutions. If you cannot resolve the problem, call the Boston ComninS ‘HOTFLINE’ at 
(617)-253-0007. If none of the consuitants are available, please leave a message on the answering 
machine and someone will call you back. 

Piease report ‘crashes’ (defined below} to the Boston ComminS ‘HOTLINE’; try to describe as many of 
the keystrokes and system uctions leading up to the crash as you remember. 


Symptom Possible Problems Solution 
The program does not start up. Not enough memory in your PC. — Install more memory. 
and does not respond to the (You need at least 256 K of 
keyboard. RAM in order to run the 


Boston CommInS program.) 


The program ‘freezes’ while: Some previous program left the Re-boot the PC and re-start the 
starting up, and does not PC in an unusable state program. 
respond to the keykoard. (probably because of 


disorderly termination). 


Tire program stops responding The program has crashed. Re-boot the PC and restart the 
to the keyboard. program using the command 
"cis -r", Please rapert the 
crash to the Boston 
CommiInS ‘HOTLINE’. 


The program prints a "Fata! The system files are in an Re-start the program using the 
Error" message wnen inconsistent state (perhaps command "cis -r”" (See 
starting up. because of a previous crash Appendix 1.6). 


or accidental snutdown). 


The program exits to DOS The program got into asituation The fileSTDOUT.TXT will 
unexpectedly. that was considered contain an error message. 
impossible, and crashed. Please record this message, 


and when you report the 
crash to the Boston 
CommiInS ‘HOTLINE’, report 
the error message as well. 
Re-boot the PC and restart 
the program using the 
command "cis -r". 


(continued) 
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Symptom Possible Problem Solution 
The number of “intact packets”’ The receiver is not connected. Make sure that the receiver is 
(in the diagnostic window) plugged in, and that the 
does not change. cable between the receiver 


and the personal computer is 
connected. 


The program Is listening to the Lither type A-V to instruct the 
wrong seriai port. program to listen to the other 
port, or connect the receiver 
to the other port. 


The radio staticn is off the air. Our data transmissions are 
carried by WERS Boston, FM 
88.9. WERS is generally off 
the air from 2:00 until 6:00 
am. Listento WERS ona 
regular FM radio, and wait 
until it comes back on the air 


The number of ‘articles Poor reception. Refer to the discussion on 
received’”’ (in the diagnostic "Antenna and Orientation" in 
window) does not change. Appendix 1.2 — Installing The 
The number ot “unframed Hardware, 


packets” and/or the number 
of ‘checksum errors” are 


increasing. 
The ieads on the antenna Move the leads on the antenna 
connector are touching. connector so they no longer 
touch. 

The number of “articles The program does not nave a Either re-start the program ina 
received”’ (in the diagnostic filter. directory that has a filter file 
window) is increasing, but (FILTER.TXT), or insert one 
the number of “matching or more filter lines into the 
articles” does not change. filter window. 

The number of “matching The program does nothave any Cony tie CONFIG.TXT file from 
articles” (in the diagnostic Keys loaded. the cisiribution disk into the 
window) does nat change. \news directory, and re-start 
The number of “articles the program. 
received” and the number of 
“articles with unknown keys” 
are increasing at the same 
rate. 

(continued) 
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Symptom Possible Problem 


TROUBLE- SHOOTING GUIDE 


Solution 


Occasional periods of poor Radio interference. 


reception. 


Move tne receiver, antenna, and. 
PC away frotn other electrical 
equipment. 


Not using a Hayes-compatible 
1200 baud modem. 


Difficulty establishing a 
connection to a remote 
database server. 


Various connection problems. 
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Use a standard terminal or 
modem program to establish 
a connection to the remote 
server and wait until you 
receive a LOGIN: prompt 
before starting the CIS 
prograin. 

Press <A-H> to reset the 
connection from within the 
C!S program, then turn the 
modem power off and on, 
and attempt a remote query 
again. Or, attempt to 
"strobe" the moden, ie. 
press <A-V> twice. 
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Appendix lV — Differences from Version 6.0 (7) 


IV.1 — Keystroke Changes 
In an attempt to make the program easier to use, we have changed some of our keystroke bindings to 


a "more standard" fori: 


Old Key 


? 


<C-C> 


<Enter> 


<A-Y> 


Explanation 

The Fi key replaces ? and instructs the system to display the help file. it contains 
an overview of commands and queries. 

The F3 key replaces F10 and instructs the system to display the window selection 
The / key replaces the <Esc> to display the command menu for the current 
window (see Section 2 — Using the ComminS Software). Additionally, <Ese> no 
longer ts used to prscess menu items, see <Enter> below. 


The <Esc> key replaces the <C-C> and (shorthand for the command DO NOTHING) 
instructs the system to exit the current menu or cance! inserting a filter line. If 


neither of these cases apply, <Esc> still does nothing. 

Tne <Enten key instructs the system to process whatever is currently being done. 
Therefore, when there is a menu on the screen, the <Enter> key instructs the 
system to execuie the selected command. When inserting a filter line, <Enter> 
instructs the systeri to finish inserting the edited line. Any other time the <Enter> 
key (shorthand for the command SHOW SUMMARIES) instructs the system to process 
the query on the query line and to display summaries of the matching articles (see 
Section 2.1 — The Filter Window). 

The ¢A-E> key is now used for confirmation to execute commands (when 
applicable) and the <A-Y> is used to blank the screen. 

The <A-S> key replaces the F2 key and instructs the system to toguie between 
displaying and turning of the budget display. 

The F2 key replaces the F1 key and instructs the system to SHOW FILTEF WINDOW. 
The F4 key replaces the F3 key and instructs the system to SHOW SUMMARY 
WINDOW. 

The F6 key repiaces the F5 key and instructs the system to SHOW ARTICLE WINDOW, 
The F& key replaces the F7 key and instrucis the system to SHOW DIAGNOSTIC 
WINDOW, 

The F10 key repiaces the F9 key and instructs the system to SHOW CPTIONS 
WINDOW. 
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IV.2 — Remote Queries 

A brand new feature of the current software is the ability to access a complete database of New York 
limes articles. This database is stored on several database servers at MIT. Users must have a 1260 
baud modern to use this feature. 


The service is invoked by using the -d option at siartup (see Appendix 1.5.7 --- Starting the Commins 
Program) and issuing queries with <C-Enter, instead of <Enter> (see Section 2.1 -- The Filter 
Window and Figure 2-3). Also, Appendix Il will heip set up your modem for use with the software. 


IV.3 — Screen Dimming 

If no keys are pressed for ten minutes, the CIS program now enters a ‘screen protect’ mode. In this 
mode, the screen is blanked, and a message ("Bounce") is printed. This message is moved randomly 
to different piaces on the screen, The screen-dimming mode prevents the CIS display from becoming 
permanently burned into the screen. Typing any keys restores the screen, then executes the 
command indicated by the key that was pressed. The menu item "“Idie the screen (A-C)"” in the 
options window immediately blanks the screen and displays the message. 

If you prefer not to see any message when the screen is blanked, select "Blank the screen (A-Y)" 
from the options menu. This is particularly useful if you run tne CIS pregram under a multi-tasker 
such as Double-Dos (TM) or DesqView (TM), because it prevents any output from appearing on the 
screen. 


1V.4— Printer Support 

The CIS systein now suppcrts several different printer mcdels. 

IBM printers may be run in the default (background) mode. In this mode, additional CIS commands 
can be processed while tne article is being printed. Also, relevant words atid phrases are highlighted 
when articles are printed on the IBM printer. In background made, the CIS program sends characters 
directly to the printer, bypassing print spoolers anc! all DOS calis. 

Other printers may be used in ‘foreground’. No additional! CiS commaiids can be entered until 
printing is complete. In foreground mode, the CIS system sends characters to the printer by issuing 
DOS calls. Special printer drivers and spoolers may be used. 

The foreground mode may de invoked using the shorthand (A-G) (see Section 2.5 — The Options 
Window) or at startup using the -p option (see Appendix 1.5.1 — Starting the ~ommInsS Pregram). 
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Appendix V— Summary of Commands 


V.1— Special Function Keys 
The following keys on the PC keyboard have special meaning to the Commins software: 


Fi 


F3 


<Enter> 


<C-Enter> 


The F1 key instructs the system to display the help file. It contains an overview of 
commands and quaries. 

The F3 key (shorthand for the command SHOW WINDOW SELECTION MENU) instructs 
the system to display the window selection menu. 


The / key instructs the system to display the command menu for the current 
window (see Section 2 — Using the ComminS Software). 

The <Esc> key (shorthand for the command DO NOTHING) instructs tne system to 
exit the current menu or cance! inserting a filter line. If neither of these cases apply 
<Esc> still does nothing. 


The <Enter> key instructs the system to process whatever is currently being done. 
When there is a menu on the screen, the <Enter> key instructs the system to 
execute the selected command. When inserting a filter line (or editing a budget), 
<Enter> instructs the system to insert the edited line (cr budget). Any other time the 
<Enter> key (shorihand for the command SHOW SUMMARIES) instructs the system to 
process the query on the query line and to display summaries of the matching 
articles (see Section 2.1 — The Filter Window). 

The <Control-Enter> key (shorthand for the command SHOW SUMMARIES FROM 
REMOTE SYSTEM) instructs the system to submit the query on the query line to a 
remote database server and to display sunirmaries of the matching articles (see 
Section 2.1 — The Filter Window): 


V.2— Scroll Keys 
The following keys can be used to scroll through a window: 


<PgDn> 
<PgUp> 
<Home> 
<End> 
1 

i 
Shift-| 
Shift-T 


Show the next page 

Show the previous page 

Show the first page of the window 
Show the last page of the window 
Select the next line (or summary) 
Select the previous line (or summary) 
Move forward one line (or summary) 
Move back one line (or summary) 


COMMINS USER’S MANUAL SUMMARY OF COMMANDS 


V.3— Editing Keys 

The following keys can be used to edit the query line. They can also be used in the ‘edit boxes’ 
created by the commands CHANGE BUDGET OF CURRENT LINE and INSERT A NEW LINE. Note: the 
<Backspace> key is the key with a left arrow («—) on a gray background. 


<Backspace> delete the character before the cursor 


C-W delete the word befure the cursor 

C-D delete the character after the cursor 

C-K delete everything after the cursor 

<Deb> delete the entire ling 

tor C-B move the cursor to tne left 

—orC-F move the cursor to the right 

C-A move the cursor to ihe beginning of the line 
C-E move the cursor to ine end of the line 


V.4— Alphabetical Listing of Conimmands 

The next page contains an alphabetical listing of the commands recognized by the Commins 
software, along with their shorthand «eys and the menu(s) in which each command is listed.'® The 
shorthand keys for the cominands listed in the window selection menu and the options window 
command menu are available in every window; these keys are marked with an asterisk. Ail other 
shorthand keys are available in a given window only if the corresponding command is listed in the 
command menu for that window. 


18 the prefix “A-” refers to the (Alt key: for example, A-B means “hald dewn the <AID key and press b”. Similarly, the 
prefix “C-" refers to the <CtrD key: for example, C-D inaans “hold down the <CtrD key and press d”. 


SUMMARY OF COMMANDS 


Name of Command 


BLANK THE SCREEN 

CHANGE BUDGET OF CURRENT LINE 
DELETE ALL ARTICLES IN LIST 
DELETE ALL MATCHING ARTICLES 
DELETE CURRENT ARTICLE 

DELETE, THEN SHOW NEXT ARTICLE 
DELETE, THEN SHOW NEXT UNREAD 
DELETE, THEN SHOW SUMMARIES 
DO NOTHING 

EXIT TO DOS 

HANGISP REMOTE CONNECTION 
IDLE THE SCREEN 

INSER® A NEW LINE 

MOVE CURRENT LINE DOWN 

MOVE CURRENT LINE UP 

PRINT ALL ARTICLES IN LIST 

PRINT ALL MATCHING ARTICLES 
PRINT CURRENT ARTICLE 

PRINT CURRENT ARTICLE 

PRINT IN BACKGROUND/FOREGROUND 
REMOVE CURRENT LINE 

RESET COUNTERS TO ZERO 

SHOW ARTICLE WINDOW 

SHOW CURRENT ARTICLE 

SHOW DIAGNOSTIC WINDOW 
SHOW FILTER WINDOW 

SHOW FIRST ARTICLE 

SHOW HELP FILE 

SHOW NEXT ARTICLE 

SHOW NEXT UNREAD ARTICLE 
SHOW OPTIONS WINDOW 

SHOW REMOTE SUMMARIES 

SHOW SUMMARIES 

SHOW SUMMARY WINDOW 

SHOW (THE) WINDOW SELECTION MENU 
STOP PRINTING AND EMPTY QUEUE 
SWAP MOGDEM/ RECEIVER PORTS 
TURN BEEP-ON-ARRIVAL ON/OFF 
TURN BUDGET DISPLAY ON/OFF 
TURN PRINT-GN-ARRIVAL ON/OFF 
TURN RECEIVER ON/OFF 


Shorthand 
A-Y 7 
A-B 

A-K 

A-K 

A-D 

A-D 

A-J 

A-M 

<Esc> * 
A-X - 
A-H . 
A-C - 
A-| 

A-N 

A-U 

A-A 

A-A 

A-P 

A-P 

A-G ‘i 
A-W 

A-O 

F6 * 
A-R 

F8 * 
F2 * 
A-R 

F1 

A-IN 

A-Z 

F10 * 
<C-Enter> * 
<Enter> * 
F4 - 
F3 * 
A-Q is 
A-V : 
A-1 

A-S * 
A-2 

A-O * 
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Listed in: 


options window command menu 
filter window command menu 
summary window command menu 
filter windcw command menu 
summary window command menu 
article window command menu 
article window command menu 
article window command menu 
every menu 

every rnenu 

options wiridow command menu 
options window command menu 
filter window Command menu 
filter windc w command menu 
filter window command menu 
summary window command menu 
filter window command menu 
filter windcw command menu 
summary vindow command menu 
options window command menu 
filter windcw command menu 
diagnostic window command menu 
window seiection menu 

summary window command menu 
window selection menu 

window seloction menu 

filter window command menu 
startuo message 

ariicle wincaw command menu 
article window command menu 
window selection menu 

filter window command menu 
filler window command menu 
window selection menu 

every meni: 

options window command menu 
cptions wir:dow command menu 
filter window command menu 
options window command menu 
filter window command menu 
options window command menu 
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Appendix VI — Files used by the system 


Yt.1— The CommiInS Directory File 

The ComminS directory file, CIS -DIR.TXT, contains information about the articles on the disk: it 
contains an index, which is used to speed up the processing of queries, and it contains summaries of 
the articles, so that these can be displayed without delay. It also contains a list of articles that you 
have deleted, so that these articles can be filtered out if they are received again. 

When the program is running, the contents of the directory file is stored in memory; it is saved on the 
disk only when you exit from the program. This explains why the prcgram should always be stopped 
using the EXIT command. It the directory file is missing, the program should be started with the" -r" 
option (see Appendix 1.6 — Restarting after a Crash or Accidental Shutdown). 


VI.2 — The Filter File 

vhe filter file, FILTER.TXT, contains your personal filter. In this file, each filter line is stored as a 
separate line, along with two numbers: the first number is the budget for that line, and the second 
number indicates whether “beep” or “‘print’’ is turned on for that filter tine (see Section 2.1 —- The 


Filter Window). 


VI.3— The Help File 
The help file, HELP.TXT, contains a brief description of how to use the systern. The system displays 
“he tutorial when you press F1. 


Vi.d— The Configuration File 
the configuration file, CONF!IG.TX7, contains information that is used by the CIS program, but may 
hange at a future date. Currently, there are entries for two kinds ot information, decryption keys and 
ramote database descriptors. 
An eniry for a decryption key includes a key number and the hexadecimal representation of the key: 

k 17001 131b3df7ea8fbb20 
én entry for a remote database includes the telephone number used to access ihe database and a 
description of the coritents of the database: 

d 2587161 ((type: nyt) & (date: [date -90 : 0])) 


VI.65 — The Error File 

The error file, STDOUT.TXT, is written whenever the program exits. It normally does not contain any 
useful information; however, when the program exits to DOS unexpectedly, it leaves an error message 
in this file. Please record this message, and report it to the Boston ComminS ‘HOTLINE’ at 
(617)-253-0007. 
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V1.6 — Article Files . 
Article files have names of the form TYMMDON.NNN, where T indicates the type of the article (A for 
Associated Press, N for New York Times, or C for ComminS announcements); Y is the last digit of the 
year, mM is the month, Do is the date, and N.NNN is a four-digit serial number. Each article file 
contains a number indicating the number of lines of text, folawed by a set of numbers that indicate 
which words in the article should be highlighted for display (see Section 2.3 — The Article Window), 
followed by the text of the article. yes 
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Appendix VIl — Your Responsibilities 

As a volunteer in the experiment to test the Boston Community Information System, you have several 
responsibilities. A copy.of the agreement that you have signed is reproduced on the next page as 
Figure V-1. 


Vil.1 —- Your Responsibilities 1o the Boston ComminS Project 
We at the Boston CommiInS project want and need your active participation in the evaluation and 
testing of the ComminS hardware, software and documentation. This means that we would like you to 
e use the system to the fullest extent of its features, 
e give us your thoughtful appraisal of the existing features, and 
e give us your suggestions for possible improvements. 
You may express these ideas, suggestions, and questions to us in many ways — in writing or by 
telephone — as often as you wish. However, at a minimum, and even if you: have provided feedback 
in other forms, you must fill out a Questionnaire once a month. This is the minimal requirement for 
your continued participation in the experiment. 


Vil.2— Your Responsibilities Regarding Use of the Information Reccived 

To conduct this unique experiment in the digital broadcast of news and information, MIT has entered 
into understandings and legal agreements with the Associated Press, the New York Times Company 
and Mead Data Central, Inc. As a volunteer in this experiment, you have aareed 


1.not to make more than one copy —- in any form — of any information 
received; 

2. not to retain copies — in any form — of more than an “insubstantial part” of 
the information received; 

3. not to transfer any of the information received --- in any farn. — to third 
parties, whetner o7 not for profit; and ; 

4. noi to retain any of the information received from the New Yor! Times — in 
any form — for more than 90 days. 

5. to return all the equipment to MIT upori request. 


In view of the unique nature of this experiment, we feel that ine responsit-lities outlines above are 
reasonable. !f you do not act in keeping with the letter and the spirit of the auieement, we will request 
that you return all loaned equipment and software to us immediately. 
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BostonCommins 253-0007 
c/o MIT Laboratory for Computer Science, Room NE43-403 
545 Technology Square, Cambridge, MA 02139 


Revised 29 September 1986 


Full Name (printed): 


Legal Agreement with Mead Data Central, Inc. 


The above designated “Recipient” agrees that it will not retain any copies of data from the New 
York Times in any form, whether print, machine readable or otherwise for 8 period of more 
than 90 days, and that any such data retained will be 1) limited to single copies, 2) never 
consist of more than en insubstantial part of the entire database made available to MIT, and 3) 
will not be transferred, whether or not for profit to any third party. It is agreed that all copies 
of such data will be returned or destroyed earlier than the 90-day maximum retention period 
upon written request from MIT, The New York Times Company, or Mead Data Central, Inc. 


Agreed 
Signature of Recipient Date 


Understanding and Agreement with MIT 


Whether or not for profit, | understand and agree not to transfer in printed or electronic form 
any information received via the Boston Commins project to any third perty. 


| understand and agree that | must complete and return e questionnaire provided for that purpose 
to the Boston ComminS Project once a month or else have to return the receiver and software to 
the project. 

| understand and agree that the software and hardware will remain the property of MIT and that | 
must return all the materials used in this test of the Boston Commins system either (i) at the 
end of the experiment in approximately 12 months or (ii) upon written notice from the project 
-- whichever comes first. 


| understand and agree that MIT has made no expressed nor implied guarantees to provide this 
information service without interuption throughout the duration of the experimental test. 


Agreed 


Signature of Recipient Date 


Copies of this signed agreement will be held by (i) the Recipient, (ii) the Boston Commins 
Project at MIT, and Mead Date Central, Inc. 


Figure VIl-1: Text of Agreement 
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